feat(commands): defineCommand — typed declarative commands via an ICommand adapter - #6101

#!/bin/bash
# Description: Determine whether a per-command description can be carried on the command object.
set -uo pipefail

# ICommand / ICommandOptions surface
fd -t f 'commands.d.ts' lib | xargs -r rg -n -C4 'interface ICommand\b|interface ICommandOptions'

# How help resolves per-command text
rg -n -C4 --type=ts 'commandHelp|getCommandHelp|helpCommand|description' lib/common/services/help-service.ts 2>/dev/null

# Any existing consumer of a description on a command object
rg -nP --type=ts -C3 '\bcommand\.description\b|\bdescription\b.*ICommand'

#!/bin/bash
set -uo pipefail

printf 'Repo files matching command-definition-adapter.ts / define-command.ts:\n'
fd -t f 'command-definition-adapter.ts|define-command.ts|defining-commands.md' .

printf '\nCommandDefinitionAdapter adapter relevant section:\n'
f="$(fd -t f 'command-definition-adapter.ts' . | head -n1)"
[ -n "$f" ] && sed -n '130,210p' "$f" | nl -ba -v130

printf '\ndefine-command validation around description:\n'
f="$(fd -t f 'define-command.ts' . | head -n1)"
[ -n "$f" ] && sed -n '280,330p' "$f" | nl -ba -v280

printf '\nhelp service description consumers:\�'
fd -t f 'help-service.ts' lib | xargs -r sed -n '1,260p' | nl -ba | rg -n -C5 'description|commandHelp|getCommandHelp|helpCommand|ICommand'

printf '\nFind descriptions in declarations and commands.d.ts:\n'
fd -t f 'commands.d.ts' lib | xargs -r rg -n -C3 'interface ICommandOptions\b|interface ICommand\b|description'

#!/bin/bash
set -uo pipefail

f_adapter="$(fd -t f 'command-definition-adapter.ts' . | head -n1)"
f_define="$(fd -t f 'define-command.ts' . | head -n1)"
f_help="$(fd -t f 'help-service.ts' lib | head -n1)"
f_decl="$(fd -t f 'commands.d.ts' lib | head -n1)"

printf 'adapter %s validation and transform:\n' "$f_adapter"
sed -n '130,210p' "$f_adapter"

printf '\ndefine validation %s:\n' "$f_define"
sed -n '260,335p' "$f_define"

printf '\nhelp service relevant description/help consumers %s:\n' "$f_help"
sed -n '1,240p' "$f_help" | grep -n -C 5 'description\|commandHelp\|getCommandHelp\|helpCommand\|ICommand' || true

printf '\ndeclarations %s:\n' "$f_decl"
sed -n '1,80p' "$f_decl"

printf '\nAny TypeScript/d declaration consumers for command.description:\n'
rg -n -C 3 --iglob '*.{ts,d.ts}' '\\bcommand\.description\b|ICommandOptions' .

#!/bin/bash
set -uo pipefail

printf 'DefineCommand and CommandDefinition type definitions:\n'
rg -n -C8 -P 'type DefinedCommand|interface (CommandDefinition|ICommandOptions)\b|description' lib/common/define-command.ts lib/common/declarations.d.ts

printf '\nHelpService full relevant methods around reading command files:\n'
f="$(fd -t f 'help-service.ts' lib | head -n1)"
sed -n '80,220p' "$f"

printf '\nCommandData interface and construction references:\n'
rg -n -C4 -P 'interface ICommandData\b|type ICommandData\b|showCommandLineHelp|openHelpForCommandInBrowser|ICommandData' lib test | head -n 240

printf '\ncommand-definition-adapter usages and validateDefinition references:\n'
rg -n -C3 'registerCommandDefinition|defineCommand|validateDefinition|definition\.description|DEFINITION_FIELDS' lib test

#!/bin/bash
set -uo pipefail

rg -n --iglob '*.{md,d.ts,ts}' -C3 '\binterface ICommandData\b|\btype ICommandData\b|description' test/define-command.ts test || true

printf '\nCheck help markup references in generated command descriptions:\n'
rg -n --iglob '*.{md,d.ts,ts}' -C2 'Generated from command\\.|commandDescription|module\.commandDescription|#{module\.command' .

printf '\nCheck exact help service methods that read command docs:\n'
f="$(fd -t f 'help-service.ts' lib | head -n1)"
sed -n '220,340p' "$f"

printf '\nRead command-definition-adapter mapping section using Python line numbers:\n'
python3 - <<'PY'
from pathlib import Path
for p in Path('.').rglob('command-definition-adapter.ts'):
    print(f'\n{p}')
    text = p.read_text()
    lines = text.splitlines()
    for i in range(max(0, len(lines)-1), -1, -1):
        if 'function createCommandFromDefinition' in lines[i]:
            start = max(0, i-10); end = min(len(lines), i+90)
            break
    else:
        continue
    for n, line in enumerate(lines[start:end], start=start+1):
        print(f'{n:4d}\t{line}')
PY